home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / opengldoc / glspec / fog_offset.spec < prev    next >
Encoding:
Text File  |  1996-11-11  |  3.0 KB  |  108 lines
  1. Name
  2.  
  3.     SGIX_fog_offset
  4.  
  5. Name Strings
  6.  
  7.     GL_SGIX_fog_offset
  8.  
  9. Version
  10.  
  11.     $Date: 1996/04/01 23:22:48 $ $Revision: 1.1 $
  12.  
  13. Number
  14.  
  15.     65
  16.  
  17. Dependencies
  18.  
  19.     XXX
  20.  
  21. Overview
  22.  
  23.     This extension allows to make objects look brighter in the foggy 
  24.     environment. GL_FOG_OFFSET_VALUE_SGIX parameter specifies point 
  25.     coordinates in eye-space and offset amount toward viewpoint.
  26.     Once fog offset is specified and enabled using GL_FOG_OFFSET_SGIX 
  27.     parameter, it will be subtracted from the depth value (to make objects 
  28.     closer to the viewer) right before fog calculation. As a result objects 
  29.     look less foggy.
  30.     
  31.  
  32. New Procedures and Functions
  33.  
  34.     None
  35.  
  36. New Tokens
  37.  
  38.     Accepted by the <cap> parameter of Enable, Disable, and IsEnabled
  39.  
  40.     GL_FOG_OFFSET_SGIX
  41.  
  42.     Accepted by the <pname> parameter of GetBooleanv, GetIntegerv, GetFloatv, 
  43.     and GetDoublev, and by the <pname> parameter of Fogiv and Fogfv:
  44.  
  45.     GL_FOG_OFFSET_VALUE_SGIX
  46.  
  47. Additions to Chapter 2 of the 1.0 Specification (OpenGL Operation)
  48.  
  49.     None
  50.  
  51. Additions to Chapter 3 of the 1.0 Specification (Rasterization)
  52.  
  53.  
  54.     3.9 Fog
  55.     When fog is enabled it is equally applied to the all objects in the scene.
  56.     This can create unrealistic effects for the objects with a high brightness 
  57.     (light sources for instance). To make such objects look brighter fog 
  58.     offset may be subtracted from the eye-distance before it is used for the 
  59.     fog calculation. Fog offset value may be specified by calling the glFog 
  60.     function with GL_FOG_OFFSET_VALUE_SGIX <pname> and four <params>.
  61.     First three parameters are point coordinates in the eye-space and fourth 
  62.     parameter is an offset distance in the eye-space. If final distance is
  63.     negative as a result of offset subtraction it is clamped to 0.
  64.     In the case of perspective projection fog offset will be properly 
  65.     calculated for the objects surrounding the given point. If objects are too
  66.     far away from the given point fog offset value should be redefined again. 
  67.     In the case of ortho projection fog offset value is correct for any object 
  68.     location.
  69.     Fog offset can be enabled/disabled by calling glEnable/glDisable functions 
  70.     with GL_FOG_OFFSET_SGIX parameter.
  71.  
  72.  
  73. Additions to Chapter 4 of the 1.0 Specification (Per-Fragment Operations
  74. and the Framebuffer)
  75.  
  76.     None
  77.  
  78. Additions to Chapter 5 of the 1.0 Specification (Special Functions)
  79.  
  80.     None
  81.  
  82. Additions to Chapter 6 of the 1.0 Specification (State and State Requests)
  83.  
  84.     The value of the fog offset is queried by calling GetBooleanv, GetIntegerv, 
  85.     GetFloatv, and GetDoublev with <pname> set to GL_FOG_OFFSET_VALUE_SGIX.
  86.     Fog offset enable/disable state is checked by calling glIsEnable function 
  87.     with GL_FOG_OFFSET_SGIX parameter.
  88.  
  89. Additions to the GLX Specification
  90.  
  91.     None
  92.  
  93. Errors
  94.  
  95.     None
  96.  
  97. New State
  98.  
  99.     Get Value            Get Command        Type        Initial Value    Attribute
  100.     ---------            -----------        ----        -------------    ---------
  101.     FOG_OFFSET_SGIX        IsEnabled        B        FALSE        fog
  102.     FOG_OFFSET_VALUE_SGIX    GetFloatv        4 * R        (0, 0, 0, 0)    fog
  103.  
  104.  
  105. New Implementation Dependent State
  106.  
  107.     None
  108.